package com.stellar.circle.basic.dao;

import com.stellar.circle.basic.entity.SPost;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Update;

import java.util.List;
import java.util.Set;

/**
 * 校园墙帖子表(SPost)数据访问层
 *
 * @author Jqchan
 * @since 2025-05-17 19:23:35
 */
public interface SPostDao {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键ID
     */
    SPost queryById(@Param("id") Long id);

    /**
     * 条件查询单条结果
     *
     * @param condition 查询条件
     */
    SPost queryByCondition(@Param("condition") SPost condition);

    /**
     * 条件查询所有结果
     *
     * @param condition 查询条件
     */
    List<SPost> queryAllByCondition(@Param("condition") SPost condition);

    /**
     * 分页查询
     *
     * @param condition 查询条件
     * @param page      页码
     * @param pageSize  每页数量
     */
    List<SPost> page(@Param("condition") SPost condition,
                     @Param("page") int page,
                     @Param("pageSize") int pageSize);

    /**
     * 条件统计
     *
     * @param condition 统计条件
     */
    Long count(@Param("condition") SPost condition);

    /**
     * 新增数据
     *
     * @param entity 实例对象
     */
    int insert(@Param("entity") SPost entity);

    /**
     * 批量新增
     *
     * @param entities 实例列表
     */
    int insertBatch(@Param("entities") List<SPost> entities);

    /**
     * 更新数据
     *
     * @param entity 实例对象
     */
    int update(@Param("entity") SPost entity);

    /**
     * 通过主键删除
     *
     * @param id 主键ID
     */
    int deleteById(@Param("id") Long id);

    /**
     * 浏览量增加
     *
     * @param postId
     * @return
     */
    @Update("update s_post set view_count = view_count + 1 where id = #{postId}")
    int view(@Param("postId") Long postId);

    /**
     * 批量查询
     *
     * @param postIds
     * @return
     */
    List<SPost> batchQueryByIds(@Param("postIds") Set<Long> postIds);

    /**
     * 更新评论数量
     *
     * @param sourceId
     * @param delta
     */
    @Update("update s_post set comment_count = comment_count + #{delta} where id = #{sourceId}")
    void updateCommentCount(@Param("sourceId") Long sourceId,
                            @Param("delta") int delta);
}

